home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-13 / ved331.zip / SS23.ZIP / DICMAN.DOC < prev    next >
Text File  |  1991-02-22  |  15KB  |  362 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                           Dictionary Manager v1.4
  24.                        Acropolis Software Dictionary
  25.                              Management Utility
  26.                    (C) Copyright 1991, Acropolis Software
  27.  
  28.                              Acropolis Software
  29.                                P.O. Box 5037
  30.                             Fair Oaks, CA  95628
  31.  
  32.  
  33.  
  34.  
  35.       THE LEGAL STUFF
  36.  
  37.  
  38.          Dictionary Manager is provided on an "as is" basis without
  39.          warranty of any kind expressed or implied. In no event will
  40.          Acropolis Software be liable to you for any damages, including
  41.          any lost profits, lost savings or other incidental or con-
  42.          sequential damages arising out of the use of or inability to
  43.          use the program, even if Acropolis Software has been advised
  44.          of the possibility of such damages, or for any claim by any
  45.          other party.
  46.  
  47.          Dictionary Manager v1.4 is a utility program for maintaining
  48.          the dictionary file included with Acropolis software products
  49.          which include but are not limited to ShareSpell and Acropolis
  50.          BBS.  Distribution for any other purpose is not allowed.
  51.  
  52.          Dictionary Manager is copyrighted by Acropolis Software.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.       TABLE OF CONTENTS
  59.  
  60.  
  61.  
  62.  
  63.         Introduction              ......................................  1
  64.  
  65.         File list                 ......................................  1
  66.  
  67.         Installation              ......................................  2
  68.  
  69.         Using Dictionary Manager  ......................................  3
  70.  
  71.         Quick Reference           ......................................  5
  72.  
  73.         Use with BBS software     ......................................  6
  74.                                                                         Page 1
  75.  
  76.  
  77.  
  78.       INTRODUCTION
  79.  
  80.        Dictionary Manager version 1.4 is a utility program for maintaining
  81.        the dictionary file included with Acropolis software products which
  82.        include but are not limited to ShareSpell, and Acropolis BBS version
  83.        4.22 or higher.
  84.  
  85.        Dictionary Manager allows you to add and delete words from the
  86.        dictionary used with either ShareSpell or Acropolis BBS.
  87.  
  88.  
  89.  
  90.       FILE LIST
  91.  
  92.         Dictionary Manager comes with the following files:
  93.  
  94.  
  95.            DICMAN.EXE         The Dictionary Manager Program.
  96.            DICMAN.DOC         This manual.
  97.            DICMAN14.NEW       New features / bug fix reports.
  98.  
  99.  
  100.         It you give copies of this program away you MUST include all three
  101.         files in their original form.  Distribution with one or more of
  102.         the files missing or altered in anyway is strictly prohibited.
  103.         In addition you should distribute it only with another Acropolis
  104.         Software product that makes use of it.
  105.                                                                         Page 2
  106.  
  107.  
  108.  
  109.       INSTALLATION OF DICTIONARY MANAGER
  110.  
  111.         Installation of Dictionary Manager is simple to perform.  The
  112.         only special consideration is whether you are using a hard disk
  113.         based system or a floppy disk based system.
  114.  
  115.  
  116.  
  117.            With ShareSpell:
  118.  
  119.  
  120.              HARD DISK SYSTEM:
  121.  
  122.              Copy DICMAN.EXE to the directory were you have ShareSpell
  123.              installed.  If the ShareSpell is installed properly
  124.              Dictionary Manager will be able to find the dictionary file
  125.              for you when it is executed.  Proper installation only requires
  126.              that the dictionary file ACROP.DIC is in either the directory
  127.              that Dictionary Manager is being executed from or in a directory
  128.              included in the PATH that MSDOS searches for files.
  129.  
  130.  
  131.  
  132.              FLOPPY INSTALLATION:
  133.  
  134.              Copy DICMAN.EXE to the floppy disk that holds the program you
  135.              are using and the ACROP.DIC file.  If you plan on adding a
  136.              large number of word to the dictionary I recommend that you
  137.              place ACROP.DIC on a floppy by itself and add the drive the
  138.              dictionary is to the path with the use of the MSDOS PATH=
  139.              command.
  140.  
  141.  
  142.  
  143.  
  144.            With Acropolis BBS:
  145.  
  146.              Copy DICMAN.EXE to the directory were the BBS.EXE file is
  147.              kept.  There are a few special considerations to account for
  148.              when using Dictionary Manager with Acropolis BBS.  See the
  149.              section "Use with BBS Software" for more information.
  150.                                                                         Page 3
  151.  
  152.  
  153.  
  154.       USING DICTIONARY MANAGER
  155.  
  156.         To use Dictionary Manager type DICMAN at the DOS prompt.  It will
  157.         search for the dictionary file and then read in all of the words
  158.         added by the user.
  159.  
  160.         The screen is divided into three sections.  On the left of the
  161.         screen are the words that will be in the dictionary.  At first
  162.         this list will contain the words loaded from the dictionary.  It
  163.         may be empty if no words have yet been added to it.  In the middle
  164.         of the screen is the list of available commands in addition input
  165.         widows will appear in this area.  On the right side of the screen
  166.         is the holding list.  The holding list is useful for temporarily
  167.         storing lists of words before adding them to the dictionary or
  168.         completely deleting them.
  169.  
  170.         The most basic commands are the arrow keys Page Up/Down and the
  171.         Spacebar.  They allow you to navigate around the word lists and
  172.         to mark the words to be operated on.
  173.  
  174.         The Left and Right arrow keys allow you to select the currently
  175.         active word list.  Pressing the Left arrow moves you to the
  176.         "Word List" column on the left part of the screen.   The Right
  177.         arrow moves you to the "Holding List" column on the right part of
  178.         the screen.  The currently selected column is indicated by its
  179.         name at the top of the column flashing.  Knowing which list is
  180.         currently selected is important since the other commands operate
  181.         on the current list.
  182.  
  183.         The Up and Down arrow keys allow you to move up and down in the
  184.         words displayed in the currently selected word list.  Page Up and
  185.         Down move through the list a screen at a time.  The high lighted
  186.         word in the center of the list is the current word.  Pressing the
  187.         Spacebar will mark the current word.  Marked words are indicated
  188.         by a right pointing triangle to their left.
  189.  
  190.         The commands are:
  191.  
  192.          [A]dd single word
  193.            You will be prompted to enter a word in a window in the middle
  194.            of the screen.  The word you enter will be added to the list
  195.            of words in the currently selected column.  The exception is
  196.            if the word is already present in the list it will not be added.
  197.            Added words will be maintained in alphabetical order.  If you
  198.            decide not to add a word just press [RETURN] and nothing will
  199.            be added.
  200.  
  201.          [M]ark all words
  202.            This will mark all of the words in the currently selected list.
  203.            You will be prompted to confirm the command before the words
  204.            are marked.
  205.  
  206.          [U]nmark all words
  207.            This will unmark all of the words in the currently selected list.
  208.            You will be prompted to confirm the command before the words
  209.            are unmarked.
  210.                                                                         Page 4
  211.  
  212.  
  213.          [L]oad file of words
  214.             You will be asked if you want to unmark the words that are
  215.             marked in the current word list.  A no response will leave
  216.             the words marked.  Yes will unmark all of them.  This allows
  217.             you to distinguish the words that were already in the list
  218.             from the words that are loaded from the file since the newly
  219.             loaded words will be marked as they are loaded.  If the file
  220.             you specify cannot be found you will be prompted again for a
  221.             file name.  If you decide not to load a list of words just
  222.             press the [RETURN] key.  The format for the list of words
  223.             is simple.  One word after another each on its own line.
  224.  
  225.               EXAMPLE:    BOY
  226.                           DOG
  227.                           CAT
  228.  
  229.          [E]xchange marked words
  230.            Moves the marked words in the currently selected list to the
  231.            other list.  You will be prompted to confirm the move before
  232.            it takes place.  A good example for this command is:
  233.            Load a list of words into the Holding list with the [L]oad
  234.            command.  Now scan through the words and use the Spacebar
  235.            to unmark the words you do not wish to include in the
  236.            dictionary.  Use the [E]xchange command to move the still
  237.            marked words to the Word list for inclusion in the dictionary.
  238.  
  239.          [D]elete marked words
  240.            Deletes the marked words from the currently selected list.
  241.            Use this command with caution, once the words are deleted you
  242.            will have to manually re-enter them.  You will be prompted to
  243.            confirm the deletion before it takes place.  Use it when you
  244.            have some words that you've added to the dictionary and decided
  245.            that you no longer want there.
  246.  
  247.          [W]rite words to file
  248.            Write the words from the current list to a disk file.  You will
  249.            be prompted for the name of the file to save the list of words
  250.            to.  If you decide not to save the word list just press the
  251.            [RETURN] key.  With this command and the [L]oad file of words
  252.            command you can easily move your personal words from one version
  253.            of the dictionary to the next by [W]riting the word list from
  254.            the old dictionary and then [L]oading the word list into the
  255.            new dictionary.
  256.  
  257.          [Q]uit and abandon changes
  258.            Quits Dictionary Manager without applying any of the changes
  259.            you have made to the dictionary.  It is a "save out" if you
  260.            think you have mangled the word list beyond all hopes of putting
  261.            it into the condition that you wanted it in.  Example: You
  262.            deleted all of the words.  You will be prompted to confirm the
  263.            operation.
  264.  
  265.          [S]ave Word List & Quit
  266.            This is the normal why of exiting Dictionary Manager.  All of
  267.            the user supplied words will be removed from the dictionary and
  268.            the new list of words in the "Word List" column on the left side
  269.            of the screen will be place into the dictionary.  Only the
  270.            words from the "Word List" will be place in the dictionary
  271.            regardless of whether it is the currently selected list or
  272.            not.
  273.                                                                         Page 5
  274.  
  275.  
  276.  
  277.       QUICK REFERENCE
  278.  
  279.         Left / Right Arrows
  280.           The left and right arrows select which word list is the currently
  281.           selected list.  The left arrow moves to "Word List" and the right
  282.           arrow moves to "Holding List".  The current list is indicated by
  283.           the name at the top of the column flashing.  The list that is
  284.           currently selected affects the operation of the [L]oad, [D]elete,
  285.           [A]dd, [M]ark, [U]nmark, and [E]xchange commands.
  286.  
  287.         Up / Down Arrows
  288.           The up and down arrows let you move through the current list.
  289.  
  290.         [SPACEBAR] mark word
  291.           The word that is highlighted in the current list is marked or
  292.           unmarked.  The right pointing triangle to the left of the word
  293.           indicates that it is marked.
  294.  
  295.         [A]dd Single Word
  296.           Allows you to type in a word manually to add to the currently
  297.           selected list.
  298.  
  299.         [L]oad file of words
  300.           Load a file containing a list of word into the currently selected
  301.           word list.  The file must have a format of one word per line.
  302.  
  303.         [W]rite words to file
  304.           Write the words from the current list to a disk file.
  305.  
  306.         [E]xchange marked words
  307.           Move the marked words from the currently selected list to the
  308.           other list.  If the "Word List" is flashing then the marked words
  309.           from it will be moved to the holding list.  If "Holding List" is
  310.           flashing then the marked words from it will be moved to the other
  311.           list.
  312.  
  313.         [D]elete marked words
  314.           Delete the marked words in the currently selected list.
  315.           *WARNING* once deleted you cannot retrieve the words again without
  316.           manually entering them or recovering them from a file.
  317.  
  318.         [M]ark all words
  319.           Mark all words in the currently selected list.
  320.  
  321.         [U]nmark all words
  322.           Unmark all words in the currently selected list.
  323.  
  324.         [Q]uit and abandon changes
  325.           Quit Dictionary Manager and abandon any changes make to the
  326.           dictionary.
  327.  
  328.         [S]ave Word List & Quit
  329.           Save the words in "Word List" back into the dictionary.  The old
  330.           user created words are removed from the dictionary and replaced
  331.           with the words in that list.
  332.                                                                         Page 6
  333.  
  334.  
  335.  
  336.       USE WITH ACROPOLIS BBS SOFTWARE
  337.  
  338.       Using Dictionary Manager with Acropolis BBS software adds a small
  339.       amount of complexity to the problem of maintaining the dictionary.
  340.       Since the BBS software doesn't allow the direct addition of words
  341.       to the dictionary all of the new words come from a file stored
  342.       with the BBS data files.  So you will be using it mostly to add
  343.       the file ADDLIST.TXT from the DFS directory.  The recommendation
  344.       is to create a batch file to start Dictionary Manager and then
  345.       delete the ADDLIST.TXT file so you do not have the same list of
  346.       words to add again and again.
  347.  
  348.       Create a batch file that looks like the following:
  349.  
  350.         COPY DFS\ADDLIST.TXT ADDLIST.TXT
  351.         DICMAN
  352.         DEL DFS\ADDLIST.TXT
  353.  
  354.       Call it something like ADDDICT.BAT.  That way the dictionary
  355.       addition file created by the BBS will be deleted when you finish
  356.       adding the words.  The reason for copying the addition list file
  357.       is that if you use the [Q]uit and abandon changes option the batch
  358.       file would have deleted your only copy of the file containing the
  359.       words.  Another benefit is that you do not have to type in the path
  360.       as part of the file name when you load the word list in, just type
  361.       ADDLIST.TXT.  It makes life a little simpler.
  362.